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CHAPTER 1 



INTRODUCTION 



This manual describes California Computer Systems' System 
300 version of CP/M 2.2. It is intended as a supplement to, 
not a substitute for, the basic CP/M documentation and covers 
only CCS's additions and medications to the standard CP/M 
package as received from Digital Research. It assumes a basic 
knowledge of CP/M terms and organization on the part of the 
reader and is oriented to the systems programmer, although the 
system operator may have reason to consult the description of 
the utility programs in Chapter 3. 

The standard distribution version of CP/M is designed to 
work with an Intel Microprocessor Development System. CCS has 
made the necessary modifications to the operating system for 
it to work with CCS's System 300 and has expanded its drive 
handling capabilities. As distributed, the System 300 CP/M 
supports the following: 



* Single-sided and double-sided 8" floppy disk drives 

* Single-sided 5.25" floppy disk drives 

* Single- and double-density diskettes conforming to the IBM 
3740 and System 34 formats and containing either 128, 256, 
512, or 1024 bytes per sector 

* A console device 

* A serial printer 

* A Centronics-type parallel printer 



Simple modifications to the software will enable the System 
300 CP/M to support double-sided, instead of single-sided, 
5.25" floppy disk drives. 



The extensively modified or unique portions of the 
software include the system loader, the BIOS, and, to support 
the new capabilities of the BIOS, several utility programs. 



1-2 Introduction 



The BIOS and the system loaders are described in the next 
chapter; Chapter 3 describes the utility programs. To aid the 
customizing of the software, the appendices describe how to 
tailor the software for different applications. 
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2.1 SYSTEM MEMORY CONFIGURATION 



The system load in memory is organized as shown in the 
Digital Research Manual "CP/M 2.2 Interface Guide." However, 
the base of the system load, CBASE, is negatively offset 2K 
compared to the normal CP/M load to allow for the enlarged 
BIOS. Thus while CBASE in a 64K version of Digital Research's 
standard CP/M 2.2 is at E400h, it is at DC00H in CCS's 64K 
version. For each size memory configuration, then, the space 
available for the TPA in CCS's version is 2K less than in a 
normal CP/M load. This is true even when a transient program 
overlays the CCP; the beginning address of the system load in 
this case, FBASE, is also negatively offset 2K from the 
standard CP/M load. Please note that the entry points into 
the BIOS will also be offset by 2K, or 800h. 



2.2 RESERVED PAGE RAM 



Page (00H-0FFH) in a CP/M system is reserved for system 
parameters . The System 300 CP/M uses some unique parameters 
in addition to the standard CP/M parameters. Table 2-1 on the 
following page lists the page locations used by the System 
300 CP/M. 
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,. •■.... .1 



Address 
0000H-0002H 



Contents 



0004H 



0005H-0007H 



0040H-0053H 



These locations contain a jump instruction to 
the warm- start entry point, 4203H + bias (the 
bias is equal to the difference, converted 
into hex, between the system memory size in 
Kbytes and 20K. 

The Intel Standard lOBYTE is stored in this 
0003H location. It is set to its default value by 

the BIOS during cold-starts and is preserved 
during warm-starts. 



The current default drive number is 
this location. 



stored in 



These locations contain a jump instruction to 
the BDOS. The address contained in 0006-0007H 
is the beginning address of the BDOS and hence 
the lowest address in memory used by CP/M if 
the CCP is overlaid. 



0008H-000AH The first five of the seven Z-80 restart loca- 

0010H-0012H tions are not used by CP/M. The sixth restart 

0018H-001AH location (0030H-0032H) is held reserved for 

0020H-0022H future use. The seventh restart location 

0028H-002AH 0038H-003AH) contains a jump instruction into 

0030H-0032H the DDT or SID when programmed breakpoints are 

0038H-003AH used in the debug mode. 

These locations contain disk parameters used 
by CC30BOOT. Locations 0040-004FH are defined 
by CP/M as user scratch pad locations; 0050H- 
0053H are held reserved, but are not used by 
present versions of CP/M. 



005CH-007CH 
007DH-007FH 

0080H-00FFH 



The CCP uses these locations as a default file 
control block for the transient program. 

These locations are the optional default ran- 
dom record position. 

Locations 080H-0FFH are a temporary buffer for 
CC30BOOT when it is loaded into memory from 
sector 01 of Track 00 of the system disk. 



Table 2-1 Page Parameters 
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2.3 CC3 0BOOT 



The system loader CC30BOOT is designed to read the system 
into memory from floppy disk. During a cold-start entry into 
CP/M, CC30BOOT,- contained in Sector 01, Track 00 of the system 
diskette, is loaded into system memory at locations 080H-0FFH 
by the ROM-resident bootstrap loader on the disk controller 
board. Once loaded, CC30BOOT begins execution and loads into 
memory the system tracks (Tracks 00 and 01 on 8" system 
diskette and Tracks 00, 01, 02 on a 5.25" diskette.) It then 
transfers control to the cold-start routine in the BIOS. 



2.4 CC30BIOS 



CC30BIOS is California Computer Systems' customized, 
expanded BIOS designed for CCS ' s System 300. It contains the 
hardware-dependent console, printer, and disk drivers. To 
support both maxi and mini floppy diskettes of varying 
formats, it uses a modified version of CP/M's sector 
deblocking algorithms. CC30BIOS also implements the Intel MDS 
lOBYTE as described in Section 2.4.6 below and in Digital 
Research's "CP/M 2.2 Alteration Guide." 



2.4.1 Diskette Compatibility 



CC30BIOS is designed to be compatible with 8" and 5.25" 
soft-sectored unrecorded diskettes that conform to the IBM 
3740 and System 34 standards for diskette format and that have 
77 and 35 tracks per diskette, respectively. It supports 
double-sided 8" diskettes as well. Table 2-2 on the following 
page shows the compatible diskette formats . Regardless of the 
general diskette format. Track 00 of any diskette must be 
formatted in 128-byte, single-density sectors, as specified by 
the IBM standards. CCS ' s floppy disk initialization routine, 
CC30INIT, automatically formats Track 00 in 128-byte, 
single-density sectors and should be used to initialize any 
blank diskettes to ensure their compatibility with CC30BIOS. 
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I DENSITY 
1 


BYTES PER 
SECTOR 


DISKETTE 
SIZE 


SECTORS 
PER TRACK 


USER CAPACITY ! 
( BYTES ) * i 


1 Single 
|_ 


128 


5.25" 
8" 


18 
26 


73,728 1 
249,600 1 


1 — 

1 Single 

1 _ - 


256 


5.25" 
8" 


10 
15 


81,920 1 
288,000 1 


1 - 

1 Single 


512 


5.25" 
8" 


5 
8 


81,920 1 
307,200 1 


1 Single 


1024 




5.25" 
8" 


2 

4 


65,536 1 
307,200 1 


1 Double 


128 


5.25" 
8" 


29 
48 


118,784 1 
460,800 1 


1 Double 


256 




5.25" 
8" 


18 
26 


147,456 1 
499,200 1 


1 Double 


512 


5.25" 

8" 
1 


10 
15 


163,840 1 

576,000 1 
1 


1 Double 


1024 


5.25" 
8" 


5 
8 


1 — — — 1 

163,840 i 
614,400 1 



* User capacity figures based on 
5.25" drives with 35 tracks. 



single-sided drives and on 



Table 2-2. Compatible Diskette Formats 



CC30BIOS has been designed to read recorded diskettes of 
the standard 128-byte sector, single-density, single-sided 
format that have been formatted by a disk controller chip of 
the 179x family. It cannot, however, read diskettes formatted 
by a 1771 disk controller chip, nor is it guaranteed that 
CC30BIOS can read diskettes in non-standard formats recorded 
on other systems. 



2.4.2 Drive Compatibility 



The software is designed to control single-sided or 
double-sided S" floppy disk drives of the Shugart SA800/850 
type or single-sided 5.25" drives of the Shugart SA400 type. 
If the drives have been purchased from CCS, they are 
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configured for software compatibility. If they have oeen 
obtained from another source, they need to configured as 
described in the Floppy Bisk Controller Reference Manual. 
Should an application call for double-sided mini drives, 
different step rates, or mini drives containing more than 35 
tracks, see the appropriate appendix in this manual. 



2.4.3 Software Compatibility 



The deblocking capabilities of CC30BIOS add considerable 
flexibility to the System 300. However, when the deblocking 
mode is used with certain CP/M programs, the last write to 
disk may be lost . These programs complete their action by 
writing to the disk and then "warm- booting" the system to 
return control to CP/M. Normally this causes no problem, 
since in the non-deblock mode data is transferred directly to 
the disk. But in the deblocking mode, data is transferred 
first to a memory buffer which holds the data until an event 
such as a subsequent read or write or directory update 
operation forces the contents of the buffer to be written out 
to disk. An occasional result of this holding operation is 
that a reboot operation can be initiated without the memory 
buffer being emptied first. Thus the final writes of data 
never get transferred from memory to disk and are lost. To 
ensure your software is compatible with the deblocking mode, 
you can do one of the following: 

1. For new software, ensure that the final disk write 
operations are directory updates . CP/M is set up to 
immediately update the directory on the disk every time 128 
bytes of directory information (one CP/M logical sector) 
are transferred. This effectively empties the buffer 
before a warm boot is initiated. 

2. Or, after the final disk write in a routine, read any other 
physical sector. This will purge the buffer and ensure 
that the written data is transferred to the disk. 

It is not a good idea to try to solve the problem by modifying 
the warm-start routine so that it clears the buffer before 
actually doing the warm start. Because a warm start is the 
usual technique for error recovery, you could aggravate the 
error condition furcher by attempting to write potentially bad 
data onto the diskette . 
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2.4.4 Peripheral Compatibility 



CC30BIOS contains drivers routines for the two serial 
ports (SIOA and SIOB) and the parallel port (PIOA) on the 2S20 
System Processor. SIOA is defined as the default console 
port, SIOB as a serial printer port, and PIOA as a Centronics 
printer (or equivalent) parallel port. Both serial port 
drivers program the ports for asynchronous serial 
communication at 9600 baud with a serial word format of 
S-bits, one stop bit, and no parity. 

CC30BIOS supports the MDS lOBYTE function, which allows 
selection of peripherals through the STAT command. The STAT 
command divides common peripherals into four logical 
categories according to basic function: Console (primary 
channel of communication between user and system) , List 
(output list devices such as printers). Reader (paper taper 
reader) , and Punch (paper tape punch) . It allows .one of four 
physical devices to be assigned to a logical device category 
at any one time. As shipped, CC30BIOS supports the following 
physical-to- logical device assignments: 



! Logical 


Physical 


Actual Peripheral 1 


1 Category 


Device 


Label 


Selected 1 


1 CONSOLE: 


TTY 




Console 1 


1 LIST: 


TTY 




Serial Printer I 




CRT 




Console 1 




LPT 




Parallel Printer j 


1 READER: 


TTY 




Console 1 


1 PUNCH : 


TTY 




Console I 



Table 2-3. Logical-to-Physical STAT Assignments 



The teletype is the default physical device in each of the 
logical categories. See the STAT command in Digital 
Research's manual "An Introduction to CP/m Features and 
Facilities" and Section 2.4.6 below for more information. 
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2.4.5 The Primitive Disk Routines 



The primitive floppy disk routines transfer a sector of 
data at a time. If the drive has not been previously 
accessed, the routines determine the drive size (8" or 5.25") 
and disk format (bytes per; sector, density). The primitive 
disk routines will attempt up to ten times to successfully 
transfer a sector of data. To ensure' that control is returned 
to the BDOS in case the DMA transfer "hangs," a watchdog timer 
is set at the begin of the attempted disk access. If the 
sector transfer is successful, 00H is returned in the A 
register; if it is unsuccessful, a non-zero value is returned. 
During a sequential read or write to a double-sided disk, 
overflow from the last sector of a track on side continues 
on sector 01 of the same track on side 1. 



2.4.6 The Basic l/O Routines 



As mentioned in Section 2.4.4 above, the basic l/O 
routines in CC30BIOS drive ports SIOA, SIOB, and PIOA. The 
following correlation is made between the BDOS jump targets 
and the BIOS basic l/o routines: 



1 BDOS Jump 


Basic 


"i/o 


Routine Function I 


1 Targets 


Routines 




1 CONST 


CSTS 




Console Status 1 


1 CONIN 


CI 




Console Input 1 


1 CONOUT 


CO 




Console Output I 


1 LIST 


LO 




List Output 1 


1 PUNCH 


PO 




Punch Output 1 


i READER 


RI 




Reader Input I 


1 LISTST 


LSTAT 




List Status 1 



Table" 2-4. BDOS Jump Targets — BIOS Basic l/O-Routines 



The basic l/o routines support the MDS lOBYTE function. 
The lOBYTE, stored in location 0003H, contains the current 
physical-to-logical device assignments. When the system is 
first initialized, the assignments for each logical device are 
set to their default value, the teletype. The STAT command 
can be used to modify the contents of the lOBYTE, changing the 
current physical-to-logical assignments. When an l/O routine 
is called involving one of the logical devices (for example, 
the routine CONIN) , it jumps to one of the basic l/o routines 
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(listed in the first column in Table 2-5 below). Each basic 
l/O routine contains a table associating peripheral driver 
routines with the physical device assignments in its logical 
device category. The l/O routine reads the lOBYTE and then 
transfers control to the driver routine indicated by the 
physical device assignment. It is important to keep in mind 
that the physical device names are merely convenient labels; 
they are not necessarily descriptive of the actual peripheral 
they select for l/O. In most systems, for example, the actual 
peripheral selected for Console l/O by the Teletype assignment 
will be a CRT. 

CC30BIOS does not support every physical device 
assignment in every logical category. The peripheral drivers 
for those assignments it does not support are equated to the 
lOER routine (see Table 2-5 below) . The lOER routine outputs 
the 10 ASGT ERROR message and sets the physical-to-logical 
assignments to the Teletype in all categories (see Section 
2.4.7 below). See Appendix A for instructions on adding 
peripheral drivers . 

The following table lists the basic l/O routines for each 
logical device, the peripheral drivers selected by the 
physical device assignment, and the contents of the drivers. 



BASIC I/O 
ROUTINES 



PERIPHERAL DRIVERS 



CONTENTS 



LOGICAL CONSOLE DEVICE 



CI (input) 
CO (output) 
CSTS ( input 
status) 



TTY Assignment: 
TTYIN (input driver) 
TTYOUT (output driver) 
TTST (input status) 
TTOST (output status) 



SIOA input driver 
SIOA output driver 
SIOA input status 
SIOA output status 



CRT Assignment: 
CRTIN (input driver) 
CRTOUT (output driver) 
CRTST (input status) 



lOER Equate 
lOER Equate 
lOER Equate 



UCl Assignment: 
CUSIl (input driver) 
CUSOl (output driver) 
CUSTl (input status) 



lOER Equate 
lOER Equate 
lOER Equate 
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LOGICAL LIST DEVICE 



LO (output) 
LSTAT (output 
status) 



TTY Assignment: 
LSER (output driver) 
LSERT (output status) 

CRT Assignment: 
TTYOUT (output driver) 
TTOST (output status) 

LPT Assignment: 
LPRT (output driver) 
LPRTST (output status) 

ULl Assignment: 
LUSEl (output driver) 
LUSEIS (output status) 



SIOB output driver 
SIOB output status 



SIOA output driver 
SIOA output status 



PICA output driver 
PIOA output status 



lOER Equate 
lOER Equate 



LOGICAL READER DEVICE 



RI (input) 



TTY ASSIGNMENT: 
TTYRDR (input driver) 



TTYIN Equate 



PTR Assignment: 
PTRIN (input driver) 
PTRST (status) 

URl Assignment: 
RUSH (input driver) 
RUSTl (status) 

UR2 Assignment: 
RUSI2 (input driver) 
RUST2 (status) 



lOER Equate 
lOER Equate 



lOER Equate 
lOER Equate 



lOER Equate 
lOER Equate 



LOGICAL PUNCH DEVICE 



PO (output) 



TTY Assignment: 
TTYPNCH (output) 

PUN Assignment: 
HSP (output driver) 
HSPST (status) 

UPl Assignment: 
PUSOl (output driver) 
PUSTl (status) 



TTYOUT Equate 



lOER Equate 
lOER Equate 



lOER Equate 
lOER Equate 
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UP2 Assignment: 

PUS02 (output driver) lOER Equate 

PUST2 (status) lOER Equate 

Table 2-5. lOBYTE Handlers and Peripheral Drivers 



2.4.7 Error Messages 



CC30BIOS incorporates error messages for the following 
four conditions: Drive Not Ready, l/O Assignment Error, Disk 
Time Out, and Warm Boot Error. 

DRIVE NOT READY: If you try an operation with a drive 
which is not ready (i.e., the door is open) or 
nonexistent you will receive the error message 

DRIVE N NOT READY 

where N is the drive unit. To get out of the error 
condition, ready the drive (insert a diskette, shut the 
door) and hit any key oh your console device. Whatever 
program you were running at the time will then continue. 
If the problem is a nonexistent drive, you will have to 
reboot your system. 

I/O ASSIGNMENT ERROR: You can use the CP/M STAT command 
as described in the Digital Research manual "An 
Introduction to CP/M Features and Facilities" to alter 
the contents of lOBYTE and thus change the 
physical- to- logical l/o device assignments. CC30BIOS 
contains driver routines only for the teletype (TTY) 
device in each logical device categories and for the CRT 
and Line Printer (LPT) in the List category. Assigning 
any other physical device to a logical category forces a 
jump to the l/o Assignment Error routine when an l/o 
operation is performed involving that logical category. 
The message 

I/O ASGT ERR 

is output, the l/O assignments default to the teletype 
for each logical category, and control returns to CP/M. 

DISK TIMEOUT: CC30BIOS incorporates a watchdog timer 

which allows control to be returned to CP/M should a 
drive "hang" during a disk operation, such as a read, 
write, seek, or restore. At the beginning of each disk 
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operation, the watchdog timer is set for a specific time 
interval; if it times out before the disk controller 
signals end-of-job, the Disk Timeout error message 

DISK TIMEOUT 

is displayed and control is returned to the BDOS. 

BOOT ERROR: During a warm boot of CP/M, the warm-boot 
routine outputs the message 

BAD BOOT 

and rings the console bell if it cannot read the system 
after ten tries. If you hit the carriage return key, 
the routine will try ten more times to read in the 
system. 



CHAPTER 3 



SYSTEM 300 UTILITY PROGRAMS 



Most of the utility programs (also called transient 
programs) described in Section 6 of the CP/M manual "An 
Introduction to CP/M Features and Facilities" work with the 
System 300 CP/M and thus have not been altered in any way. 
However, to fully support the capabilities of the System 300 
CP/M, CCS has added utility programs and modified others. 
This chapter describes these utility programs. 

Please note that when either CC30INIT, CC30GEN, or 
CC30COPY is executing, it does not access the the printer 
driver routines in the the BIOS. This means that the console 
displays cannot be routed to the printer. Also note that the 
above programs work directly with CCS's disk controller boards 
and thus cannot work in systems using other manufacturer's 
boards . 



3.1 DOCUMENTATION COI^TVENTIONS 

The following documentation conventions are in effect in 
this chapter: 

<cr> represents a carriage return 

'^C represents a Control-C 

N> represents the default (currently selected) drive prompt, 
where N can be a letter between A and P, inclusive. 

Underlined characters in sample console displays are user 
inputs . 
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3.2 CC30INIT 



CC30INIT performs two basic functions: 1) it formats 
diskettes; 2) it verifies data integrity on already recorded 
diskettes . 



3.2.1 CC30INIT Description 



In the format mode, CC30INIT formats 5.25" and 8" single-sided 
or double-sided diskettes so that they 

a. are compatible with CC30BIOS; 

b. conform to the IBM 3740 and System 34 format standards; 

c. can be read and written to by the 179x family of disk 
controllers and the 1771 disk controller. 

After if finishes formatting the entire diskette, CC30INIT 
automatically reformats Track 00 in 128-byte, single-density 
sectors so that it conforms to the IBM format standards . It 
then verifies the diskette. 

In addition to formatting an entire diskette, CC30INIT can 
format a single track only, allowing the data on a diskette 
with one bad track to be saved. This facility can also be 
used to reformat Track 00 in any format supported by CC30INIT. 
However, CC30BOOT and the ROM bootstrap loader will then be 
unable to read the diskette. After formatting a track, 
CC30INIT automatically verifies the track. For the details of 
the formats used by CC30INIT, refer to the Programming 
Information Appendix of your Floppy Disk Controller Reference 
Manual. 

In the verification mode, CC30INIT verifies the data integrity 
of an entire diskette, indicating which records are in error. 
Note that the verification mode does not support the 
single-track option. 



3.2.2 CC30INIT Requirements/Restrictions 



In the format mode, CC30INIT does not support 128-byte, 
double-density sectors or 1024-byte, single-density sectors. 

CC30INIT can not verify diskettes written by 1771 disk 
controller chip. 

CC30INIT requires a CCS Floppy Disk Controller. 



System 300 Utilities — CC30INIT 



3-3 



3.2.3 CC30INIT Operation 



* * 

* CAUTION: CC30INIT destroys any existing data as it * 

* formats the diskette. If you wish to reformat a * 

* 

* 



diskette for CC30BIOS compatibility, yet preserve 
* its contents, see CC30COPY. 



CC30INIT relies on console interaction to receive the 
parameters it needs to format or verify a diskette. It 
accepts only a limited number of responses to the questions it 
asks and prompts for the acceptable responses. If it receives 
an unacceptable response, it repeats the question. Except as 
noted, entering a carriage return in response to any of the 
questions returns you to CP/M. The console dialog is as 
follows: 



WHICH DRIVE (A-D)? 



I Enter the drive letter of the diskette 
I to be formatted and/or verified. When 
ICC30INIT is finished, it repeats this 
I question, allowing additional diskettes 
I to be formatted or verified. A <cr> 
I returns you to CP/M. 



SINGLE OR DOUBLE SIDED (0 OR 1)? 



SINGLE OR DOUBLE DENSITY (S/D)? 



specifies single-sided; 

1 specifies double-sided. 
If you respond with a 1, 
CC30INIT formats/verifies 
both sides of the disk. 

In the format mode, your 
response must agree with 
the sector size selected 
below. If it doesn't, 
CC30INIT will return to 
this question when it 
tries to format the disk. 



TRACK NUMBER (0-80 OR *)? 



I To format or verify the entire 
I disk, enter *. To format one 
1 track only, enter the track num- 
Iber, followed by a space. If you 
I choose to format a single track, 
I make sure the format you specify 
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matches the rest of the disk — 
otherwise, CG30BIOS v/ill not be 
able to read the disk. 



SECTOR SIZE (0-3)? 



Enter the code that selects the bytes- 
per-sector formatting you desire: 



Code 


Bytes/Sector 


Density 





128 




S 


1 


256 




s/d 


2 


512 




s/d 


3 


1024 




D 



Single-density, 1024-byte sectors and 
double-density, 128-byte sectors are 
supported in the verification mode. 

SELECT INIT WITH VERIFY OR VERIFY ONLY, (0 OR 1) 

I This line appears only if you have specified the entire 
I disk for formatting or verification. Enter to format 
land verify the disk; enter 1 to verify the disk only. 
I A <cr> causes CC30INIT to restart at the first question, 
llf you specify init with verify, CC30INIT responds with: 

WARNING — CONTENTS OF DISK WILL BE 

DESTROYED. CONTINUE (Y/N)? [Enter Y if you wish the disk 

I to be formatted. Any other 
I response causes a repeat of 
Ithe previous question. 



NUMBER OF TRACKS (35, 40, 80)? 



I This question appears if the 
I selected drive is a mini. 
I Enter the number of tracks 
I per side your mini supports, 
1 followed by a space. CC30- 
I INIT prompts for and accepts 
I only those numbers supported 
I by mini drives currently on 
Ithe market. Unless altered, 
ICC30BIOS supports 35-track 
I minis only. 



VERIFYING 



CC30INIT displays this message as it verifies 
the diskette or reformatted track. 
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EXAMPLE: In the following console dialog example, a single- 
sided 8" diskette in Drive B is initialized for 1024-byte, 
double-density sectors. 

N>CC30INIT 

CCS SYSTEM 300 FORMAT PROGRAM VI . 1 

PLEASE USE CAUTION WHEN USING THIS PROGRAM 

AS IT IS POSSIBLE TO DESTROY EXISTING DATA 

WITH NO CHANCE OF RECOVERY 

WHICH DRIVE (A-D)? B. 

SINGLE OR DOUBLE SIDED (0 OR 1)? 0^ 

SINGLE OR DOUBLE DENSITY (S/D)? D 

TRACK NUMBER (0-80 OR * ) ^ 

SECTOR SIZE (0-3)? 3 

SELECT INIT WITH VERIFY OR VERIFY ONLY, (0 OR 1) 0_ 

V7ARNING — CONTENTS OF DISK WILL BE 

DESTROYED. CONTINUE (Y/N)? Y 

VERIFYING 

WHICH DRIVE (A-D)? <cr> 



3.2.4 CC30INIT Error Messages 



CC30INIT contains general error messages that are 
displayed whenever an error occurs during a disk operation. 
They identify the nature of the operation in which the error 
occurred, specify the physical location of the error (drive 
unit, diskette side, track number, sector number) , and display 
the contents of the disk controller's status register. 
Numerical values are in hex. For a definition of the status 
register, see the 1793 Data Sheet in the 2422 Floppy Disk 
Controller manual. 

HOME ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS- n 

After CC30INIT issues a Restore Command (return to Track 
00), it checks status and will display the above message if 
the drive is not ready (i.e., door open), the disk is write 
protected, or the disk controller does not report the head 
over Track 00. 

SEEK ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS- n 

CC30INIT displays the Seek Error Message if it detects one 
of the following errors after it issues a Seek Command: 
drive not ready, drive write-protected, or head on Track 

00. 
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INIT ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS-n 

CC30INIT writes an entire track at one time. After it has 
finished writing a track, it checks for error conditions. 
It displays the above message if it detects one of the 
following errors: drive not ready, drive write-protected, 
or lost data. 

READ ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS-n 

During verification of a diskette, CC30INIT displays the 
above message if it encounters one of the following error 
conditions: drive not ready, record not found, CRC error, 
or lost data. 



CC30INIT also contains error messages which flag specific 
error conditions. Some of these messages will appear in 
conjunction with the operation error messages . 



DRIVE NOT READY, PLEASE FIX AND RETRY 

If the selected drive is not ready, this message is 
displayed and CC30INIT restarts at the question WHICH DRIVE 
(A-D)? Check that the diskette is properly inserted and 
the drive door closed. 

SEEK ERROR 

After the drive has been specified, CC30INIT does a 
preliminary restore of the drive (seek to Track 00) and 
reads status. If the Track 00 flag is not set, it displays 
this error message and restarts with the V7HICH DRIVE (A-D)? 
question. 

DISKETTE IS WRITE PROTECTED PLEASE FIX 

If CC30INIT enounters a write-protected diskette, which of 
course it cannot initialize, it displays this error message 
and restarts at the question WHICH DRIVE (A-D)? Replace 
the tab on the write-protect notch (8" diskette) or remove 
the tab (5.25" diskette) before responding. 

DRIVE TYPE CONFLICT PLEASE RETRY 

This message appears for 8" drives only. If you have 
indicated that the diskette is single-sided when it is 
actually double-sided, or vice versa, CC30INIT displays 
this error message. CC30INIT then restarts with the 
question WHICH DRIVE (A-D)? Mini drives do not have an 
output indicating whether or not a diskette is 
double-sided; hence CC30INIT can do no error checking in 
the case of mltil arivSB. 
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BAD TRACK OR SECTOR SIZE/DENSITY SELECTION 

Before CC30INIT begins formatting the diskette, it ensures 
that 128-toyte double-density or 1024-byte single-density 
sectors have not been selected and that the number of the 
track to be formatted does not equal or exceed the number 
of tracks on the diskette (77 for an 8"; user-specified for 
a j^£j^£y^ j£ either the sector/density or the track 
selection is unacceptable, the above error message is 
displayed and CC30INIT returns to the console dialog, 
starting with SINGLE OR DOUBLE DENSITY (S/D)? 

DID NOT DETECT TRACK00 ON RESTORE, ABORT 

If the disk controller signals that it has finished a 
restore command but Track 00 is not flagged, CC30INIT 
displays this error message in conjunction with the Home 
Error Message and returns control to CP/M. This error 
condition usually indicates hardware malfunction. 

TRACK ZERO FLAGGED WHEN HEADS OFF ZERO, ABORT 

This error message may occur in conjunction with the Seek 
Error Message. If after a seek or step command Track 00 is 
flagged, this message is displayed and control is returned 
to CP/M. It usually indicates a hardware malfunction. 

STATUS IS LOST DATA, PROGRAM IS ABORTED 

This message is displayed in conjunction with the Init 
Error Message whenever the DRQ flag or the Lost Data flag 
is set in the status register after a track read or write. 
This error message usually indicates problems with the data 
transfer rate. If it occurs during data verification of an 
already recorded diskette, it is possible that the number 
of bytes per sector may be greater than specified in the 
console dialog. Control is returned to CP/M. 

STATUS IS RECORD NOT FOUND, Y TO CONTINUE 

This error message occurs only during verification of a 
diskette. CC30INIT will attempt four times to successfully 
read in a sector. If it is unsuccessful after the fourth 
attempt because it cannot find the sector, it will display 
the above message and query. If you enter Y, CC30INIT 
proceeds to the next sector, continuing its verification 
attempt. Any other response causes CC30INIT to restart 
with the first question in the console dialog. This error 
message usually indicates a hard error on the floppy disk. 
It might also occur during data verification of an already 
recorded diskette if the number of bytes per sector or data 
density is less than specified in the console dialog. 



3-8 System 300 Utilities--CC30INIT 



STATUS IS CRC ERROR, TYPE Y TO CONTINUE 

CC30INIT displays this error message after it has attempted 
unsuccessfully to read the disk four times because of a CRC 
error. Entering Y causes CC30INIT to proceed to the next 
sector and continue its verification attempt. Any other 
response causes CC30INIT to restart with the first question 
in the console dialog. This error message ^g^^2ly 
indicates a hard error on the diskette. 

TIMEOUT ON DISK OPERATION, DO YOU WISH TO RETRY OR 

RETURN TO CPM? PLEASE REPLY Y(ES)/N(0) 

CC30INIT sets the watchdog timer for each disk operation. 
If the watchdog timer times out before the disk controller 
signals end-of-job (INTRQ bit set), CC30INIT displays this 
message. A response of Y causes CC30INIT to restart with 
the source drive request. A response of N (or any other 
entry) causes control to be returned to CP/m. This error 
condition usually is caused by hardware malfuction. 

PREMATURE DMA TERMINATION, PROGRAM ABORTED 

The disk controller should signal end-of-job before the DMA 
transfer is terminated. If the DMA terminates before the 
disk controller reaches end of job, CC30INIT displays this 
message and returns control to CP/M. This error condition 
is usually caused by hardware malfunction. 
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3 . 3 MOVCPM 



MOVCPM allows the System 300 CP/M to be reconfigured for 
different memory sizes. 



3.3.1 MOVCPM Description 



The System 300 MOVCPM works essentially the same as 
Digital Research's program described in Section 6.9 of "An 
Introduction to CP/M Features and Facilities." It places an 
image of the System 300 CP/M into user memory at 900H, 
reconstructed for the memory size specified by the operator. 
To allow for the increased size of CC30BIOS, the System 300 
MOVCPM automatically offsets the system load 2K from the 
standard CP/M load. Note that the image it places into memory 
is the System 300 CP/M as distributed by CCS. If you have 
altered CC30BIOS, you need to patch the altered BIOS onto the 
system image as described in Appendix A. 



3.3.2 MOVCPM Operation 



The System 
commands : 



300 MOVCPM supports the following two 



N>MOVCPM * *<cr> 



N>MOVCPM n *<cr> 



Causes an image of the current memory con- 
figuration of the System 300 CP/M to be 
constructed in memory in preparation for a 
CC30GEN operation. 

Causes an image of the System 300 CP/M 
configured for n kilobytes to be con- 
structed in memory in preparation for a 
CC30GEN operation. 



Upon completion, MOVCPM displays 



READY FOR "SYSGEN" OR 
"SAVE 40 CPMxx.COM" 
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3.4 CC30GEN 



CC30GEN generates the system, either from an image 
residing in user memory or from a system diskette, onto the 
system tracks of a user-specified diskette. 



3.4.1 CC30GEN Description 



The SYSGEN routine supplied with Digiral Research's 
distribution version of CP/M works only with "standard" 
diskettes — that is, 8" diskettes formatted m 128-byLe, 
single-density sectors. Since CCS ' s System 300 CP/M is 
distributed on diskettes formatted in 1024-byte, 
double-density sectors, CCS rewrote the SYSGEN program to 
support non-standard diskettes. CC30GEN allows the system to 
be generated on 5.25" diskettes and supports the same diskette 
formats as CC30BIOS. Digital Research's standard SYSGEN 
program has also been included on the distribution diskette. 



3.4.2 CC30GEN Requirements/Restrictions 



CC30GEN requires 24K of user memory; to meet this 
requirement, the System 300 CP/M must be configured for a 
memory size of 32K or greater. 

If the size and format of the destination diskette 
results in system tracks having a smaller capacity than the 
system tracks of the source diskette, data may be lost. An 
unaltered version of the System 300 CP/M requires a system 
diskette formatted in 512-byte or 1024-byte double-density 
sectors . 



CC30GEN 
controller . 



will work only in systems with CCS's disk 



3.4.3 CC30GEN Operation 



CC30GEN prompts the user for its operating parameters. 
If it does not receive an acceptable response, it will repeat 
the question. The console dialog is as described below: 
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SOURCE DRIVE: lEnter either a drive unit letter or <cr> . 

I A carriage return indicates to CC30GEN that 
Ian iruage of CP/M already exists in memory 
I from a previous CC30GEN or MOVCPM operation 
land can be written to the drive specified 
I below. If instead of a <cr>, a source drive 
lis specified, CC30GEN examines the drive for 
I readiness and then asks for confirmation of 
I the source drive: 

SOURCE ON n, THEN TYPE RETURN I If n is the correct source 

I drive, enter <cr> . CC30GEN 
Iwill then read the system 
I tracks of the source drive 
I into memory. Any response 
I other than <cr> aborts the 
[program. 

DESTINATION DRIVE: j Enter either the destination drive unit 

I letter or <cr> . A <cr> causes control 
I to be returned to CP/M, leaving the 
I system image in memory. If you specify 
I a drive, CC30GEN examines the drive for 
I readiness. It then asks for confirma- 
Ition of the destination drive: 

DESTINATION ON n, THEN TYPE RETURN ilf n is the correct 

1 destination drive, hit 
I <cr> ; CC30GEN will then 
i begin writing the system 
I image out to disk, veri- 
1 f ying what is written. 
[Hitting any other key 
I returns control to CP/M. 

SYSTEM COPY AND VERIFICATION ENDED NO ERRORS 

1CC30GEN displays this message after it has written and 
I verified the system tracks on the destination diskette. 
ICC30GEN returns to the destination drive request, 
[allowing additional system diskettes to be generated. 



EXAMPLE: The following console dialog causes the image of 
CP/M already in memory to be written on the diskette in Drive 
B. User inputs are underlined. 
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N>CC30GEN 

CCS SYSTEM GENERATION PROGRAM VERSION 1.1 
COPYRIGHT 1980 CALIFORiHA COMPUTER SYSTEMS 

SOURCE DRIVE: <cr> 

DESTINATION DRIVE: B_ 

DESTINATION ON DRIVE B, THEN TYPE RETURN <cr> 

SYSTEM COPY AND VERIFICATION ENDED NO ERRORS 

DESTINATION DRIVE: <cr> 



3.4.4 CC30GEN Error Messages 



When CC30GEN detects a disk operation error, it displays 
an error message indicating the nature of the operation when 
the error occured, the physical location (drive, side, track, 
sector), and the contents of the disk controller's status 
register. Numerical values are in hex. The contents of the 
status register are defined in the 1793 Data Sheet in the 
Floppy Disk Controller Reference Manual. 



HOME ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS-n 

After a restore command has been issued, CC30GEN checks the 
disk controller's status. It will output the above error 
message and restart with the source drive request if the 
selected drive is not ready, if a seek or CRC error is 
detected (source drive only), or if the destination drive 
is write-protected. 

READ ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS-n 

After the disk controller has finished reading a sector, 
CC30GEN checks status. It displays the above error message 
and restarts at the source drive request if it detects any 
of the following errors: drive not ready, record not found, 
CRC error. 

V/RITE ERROR: DRIVE n; SIDE n; TRACK n; SECTOR n; STATUS-n 

After the disk controller has finished writing a sector, 
CC30GEN checks status. It displays the above error message 
and restarts at the source drive request if it detects any 
of the following errors: drive not ready, drive 
write-protected, record not found, CRC error, da.ta lost. 
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The following error messages are designed to report 
specific error conditions. They may occur in conjunction with 
the operation error messages above. 



INSUFFICIENT MEMORY SPACE — NEED 24K 

CC30GEN needs 24K of user memory to operate. It will 
display this message and return control to CP/M if CP/M is 
configured for less than 32K. 

DRIVE NOT READY PLEASE CORRECT 

If the selected drive is not ready — i.e, diskette not 
inserted, door not closed — CC30GEN displays this message 
and restarts at the source drive request. 

DISK IS WRITE PROTECTED PLEASE FIX 

If the diskette in the destination drive is write- 
protected, CC30GEN displays this message and restarts at 
the source drive request. To enable writing to the disk, 
fold the write protect tab over the notch on an 8" diskette 
or remove the write protect tab on a mini diskette. 

***WARNING: POSSIBLE LOST DATA*** 

After CC30GEN has completed writing the system to the 
destination disk, it issues this warning message if the 
capacity of the system tracks on the destination disk is 
less than required by the System 400 CP/M. CC30GEN then 
returns to the source drive request instead of the 
destination drive request as it normally does. Type two 
carriage returns if you wish to return to CP/M. Note that 
if you reduce the size of CC40BIOS, this message may still 
appear, even though the destination diskette has sufficient 
capacity for the altered system. 

RECORD NOT FOUND, ABORT 

If the disk controller reports it cannot locate the sector 
it is attempting to read or write, CC30GEN outputs the 
above error message and restarts with the source drive 
request. 

DATA COMPARISON ERROR PLEASE RETRY OR 

TYPE A CARRIAGE RETURN TWICE TO EXIT TO CPM 

After CC30GEN writes a sector to the destination diskette, 
it reads back the data and compares it to the data read in 
from the source diskette. If the data is not in agreement, 
CC30GEN displays this error message and returns to the 
source drive request. 
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3 . 5 CC30COPY 



CC30COPY makes exact copies of recorded diskettes for the 
purpose of backup. It also reinitializes recorded diskettes 
fo^ CC30BIOS compatibility or error recovery. 



3.5.1 CC30COPY Description 



CC30COPY copies the contents of a diskette recorded by a 
disk controller chip of the 179x family onto another diskette 
in a format compatible with CC30BIOS. It reads and copies one 
track at a time, reading the track on the source diskette, 
formating the corresponding track on the destination diskette, 
and then writing the data to the formatted track. It examines 
the first three tracks (Tracks 00, 01, and 02) on the source 
diskette for data density and bytes per sector, duplicating 
their formats on the corresponding tracks of the destination 
diskettes. It then assumes that the rest of the tracks have 
the same format as Track 02 . 

If you specify the same diskette as the source and the 
destination, CC30COPY reformats the diskette, preserving the 
data. This facility can be useful for recovering data on 
diskettes with soft errors. However, to ensure against data 
loss, make a backup copy of the diskette before you attempt to 
reformat it with CC30COPY. 

* * 

* NOTE: CCS assumes no liability for any data loss * 

* resulting from the use of CC30COPY. * 

* * 

********************************************************** 

CC30COPY allows the option of verifying that the data on 
the destination diskette matches the data on the source 
diskette . 



3.5.2 CC30COPY Requirements/Restrictions 



The source and destination diskettes must be the same 
size and both single- or double-sided. 
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CC30COPY requires 24K of user memory to copy a diskette; 
to acheive this, the System 300 CP/M must be configured for a 
memory size of 32K or greater. If you select the verify 
option, CC30COPY requires 32K of user memory to operate, or a 
version of System 300 CP/M configured for 40K or greater. 

CC30COPY cannot read diskettes recorded by a 1771 disk 
controller chip and requires a CCS Floppy Disk Controller to 
operate . 



3.5.3 Operation 



CC30COPY uses console interaction to obtain some of its 
operating parameters. It accepts only a limited number of 
responses to its questions and prompts for the acceptable 
responses. The console dialog is as follows: 

SOURCE DRIVE (OR CONTROL C TO ABORT) 

DESTINATION DRIVE (OR CONTROL C TO ABORT) 

|CC30COPY accepts a drive unit letter in response to 
I either of these questions. A ^C returns control to 
Icp/M. CC30COPY' examines the specified drives for com- 
Ipatibility; if they are compatible it then asks: 

DO YOU WISH TO VERIFY DATA? I If you do, enter Y; any other 

I entry is taken as negative. 
I If both drives are minis, 
icC30COPY asks: 

IS IT DOUBLE-SIDED? I Enter Y if both minis are double- 
Is ided. Any other entry is negative. 

MINI DRIVES WILL DEFAULT TO 35 TRACKS. 

IF THIS IS O.K., TYPE A CARRIAGE RETURN. OTHERWISE, 

ENTER THE NUMBER OF TRACKS: 

I Enter <cr> if your mini drives support 35 tracks. 
I Otherwise, enter the number of tracks in decimal, 
j followed by <cr> . If you make a mistake entering the 
I number, hit any character other than a number or <cr> 
land you will be given a chance to try again. 

WARNING - CONTENTS OF DESTINATION DISKETTE WILL BE LOST. 
DO YOU WISH TO CONTINUE? JThis warning appears for both 

I both mini and 8" drives. If 
lyoii wish to continue with the 
I copy, enter Y. Any other entry 
lis taken as negative. 
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COPYING TRACK nn 
VERIFYING TRACK nn 



As it copies, CC30COPY displays the 

track it is on in decimal. During 

verification of the track, the word 

I VERIFYING overwrites the word COPYING. 



CC30COPY returns to the source drive request after it has 
completed copying the disk, allowing additional copies of the 
disk to be made. A ^C returns you to CP/M. 



EXAMPLE : 

The follov/ing console dialog copies the contents of the 8" 
diskette in Drive B onto the 8" diskette in Drive C and 
verifies that the data is correct. User entries are 
underlined, 

N> CC30COPY 

CCS DISK COPY PROGRAM VERS 1.1 

SOURCE DRIVE (OR CONTROL C TO ABORT) B_ 
DESTINATION DRIVE (OR CONTROL C TO ABORT) C_ 

DO YOU WISH TO VERIFIY DATA? Y 

WARNING - CONTENTS OF DESTINATION DISKETTE WILL BE LOST 
DO YOU WISH TO CONTINUE? Y_ 

VERIFYING TRACK 77 

SOURCE DRIVE (OR CONTROL C TO ABORT) "C 



3.5.4 CC30COPY Error Messages 



INVALID DRIVE DRIVE (OR CONTROL C TO ABORT) 

If you enter anything other than A, B, C, D or ^C to the 
source or destination drive request, CC30COPY displays this 
message and waits until you enter a valid drive unit or a 
"C. 



INVALID DRIVE COMBINATION 

If you choose a destination drive of a different size than 
the source drive, CC30COPY displays this error message and 
prompts again for the source drive. 
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SOURCE AND DESTINATION DRIVES ARE NOT 

COMPATIBLE, PLEASE RETRY 

This message is displayed if your 8" source and destination 
diskettes are not both single-sided or both double-sided. 
CC30COPY restarts at the source drive request. 

BAD NUMBER - TRY AGAIN 

CC30COPY displays this message if you respond to the 
number-of-tracks query with any character other than a 
number or a carriage return. It then waits for you to 
enter either a carriage return (indicating 35 tracks per 
side) or a number followed by a carriage return. 

DRIVE NOT READY 

If the source or destination drive is not ready (e.g., the 
drive door is open) , this message is displayed and, if your 
terminal supports this feature, the terminal bell will 
ring. To allow CC30COPY to continue, ready the drive and 
then hit any key on the keyboard except "^C. "C returns you 
to cp/m. 

DRIVE IS WRITE PROTECTED - TYPE CR TO CONTINUE 

This message is displayed if the destination drive is 
write-protected. If you wish CC30COPY to continue, 
unprotect the diskette, return it to the drive, and hit the 
carriage return key. Any other response returns you to the 
first question in the dialog. 

CANNOT READ SOURCE 

If for some reason CC30COPY cannot read the source 
diskette, it displays this error message and returns to the 
first question in the dialog. Possible causes for this 
error message include an unformatted diskette or one 
formatted by a 1771 disk controller chip. 

BAD SOURCE SECTOR nn - IGNORE? 

If CC30COPY cannot read a sector on the source diskette 
after ten tries, it displays this error message and query, 
in which nn is the sector number. If you wish CC30COPY to 
continue copying the diskette enter Y. CC30COPY will 
transfer whatever it got from the sector and continue to 
the next sector. Data integrity in this case cannot be 
assured. If the error was a soft error, the data is 
probably good. If it was a hard error, the resulting data 
is unpredictable. If you enter any character other than a 
Y, CC30COPY ceases its copy attempts and restarts at the 
beginning of the console dialog. Since CC30COPY attempts 
to read a sector ten times before it displays the error 
message, it is unlikely that in subsequent attempts it will 
be any more successful in reading the sector. If you 
discover that the same sector is in error on several 
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discover that the same sector is in error on several 
contiguous tracks, the diskette probably has been scratched 
or otherwise damaged. 

DATA VERIFICATION ERROR ON THIS TRACK, DO 

YOU WISH TO CONTINUE? 

If the verification check finds that the data read from the 
destination disk does not match the data read from the 
source disk, CC30COPY displays this error message and 
query. Type Y to continue. Any other response causes 
CC30COPY to restart with the first question of the console 
dialog. 

TIMEOUT ON DISK OPERATION, ABORT 

CC30COPY sets the watchdog timer for each disk operation. 
If the timer times out before the disk controller signals 
end-of- job, CC30COPY displays this message and returns 
control to CP/M. This error condition usually results from 
a hardware malfunction. 



APPENDIX A 



CUSTOMIZING THE SYSTEM 300 CP/M 



PURPOSE: 

Appendix A describes the procedure for modifying CC30BIOS 
to support additional or different peripheral devices, 
different drive step or serial baud rates, and for patching 
the modified CC30BIOS onto CP/M. Other possible modifications 
of CC30BIOS are identified in Appendices B through D; the 
steps involved in making the modifications are too lengthy to 
be included this appendix. However, the method of patching 
the modified CC30BIOS onto CP/M is the same as described 
below. 



METHOD : 



Load CC30BIOS.ASM using ED. 

Add or alter peripheral drivers. Section 2.5.1 on the 
lOBYTE contains the background information you need to do 
so. V^en writing your driver routines, please keep the 
following points in mind: 

a. Modification of existing driver routines generally 
involves changing the contents of the peripheral 
driver only, leaving the lOBYTE handling routines 
and the driver routine name unmodified. For 
example, to bring up a default printer on any port 
other than SIOB, you need to rewrite routines LSER 
and LSERT, leaving their names the same. The only 
exception to this general rule occurs when changing 
the peripheral driven by the CRT List assignment. 
Currehtly the LisE lOBlfl*! handlers, LO and LSTAT, 
map the CRT physical assignment to the TTYOUT and 
TTOST routines; the TTYOUT and TTOST labels in the 
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LO and LSTAT tables need to be replaced with the 
names of the user-written printer output and status 
routines (see Table 2-3). 

b. Adding a peripheral involves selecting a currently 
unsupported physical device and replacing the 
associated lOER equates with driver routines of the 
same name. For example, an additional console could 
be selected by the CRT physical device assignment. 
To support such a console, the following lOER 
equates should be replaced with driver routines 
CRTIN, CRTOUT, and CRTST: 

CRTIN: EQU ' lOER 
CRTOUT: EQU lOER 
CRTST : EQU lOER 

If you plan to vector a list output routine to the 
console device, you must also write an output status 
routine (named, for example, CRTOST) . 

c. Driver routines must conform to the CP/M calling 
conventions . See Section 6 of your CP/M Alteration 
Guide, "The BIOS Entry Points," for a description of 
the responsibilities of each entry point subroutine. 
Your drivers must fulfill these responsibilities. 
Generally speaking, output drivers find the 
character in register C, while input drivers pass it 
to register A. - 

d. Console input. List output. Punch output, and Reader 
input routines require corresponding status 
routines. For example, if you are adding a 
peripheral for the User Line Printer 1 assignment, 
the lOER equates for both LUSEl (output) and LUSEIS 
(status) must be eliminated and replaced with output 
and status routines of the same name. In some 
cases, there are no lOBYTE handlers for the status 
routines (e.g., the only lOBYTE handler for the 
Reader logical device is the reader input routine, 
RI). In such cases, the input or output driver must 
call the status routine. 

e. Initialization routines must be added to the 
one-time code (at the end of the source listing) for 
those newly-supported l/o ports which require 
initialization. 

3. Review the following equates and conditional assembly 
directives at the beginning of the source code and modify 
them as needed: 
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MSIZE EQU 64 — If you plan to reconfigure the System 
300 CP/M for a memory size other than 64K, modify 
this line to reflect the desired memory size in 
Kilobytes . 

CBAUD EQU 13 — The console baud rate is set for 9600 
baud. If a baud rate other than 9600 baud is 
desired, this equate should be modified according to 
the values given in the table above it. 

PBAUD EQU 13 — This equate sets the serial printer's 
baud rate to 9600 baud. It too can be set to any of 
the values indicated in the baud rate table. 

MINI EQU TRUE; MAXI EQU TRUE — If the system will 
be using only one size drive, you can save space in 
the assembled code by eliminating code pertaining to 
the unused drive size. To do so, change the TRUE 
statement to FALSE for the unused drive type . 

STEPS EQU 3; STEPS EQU 1 — The optimal step rate for 
a drive's read/write head differs from drive to 
drive. Shugart drives require an 8 ms, 3 ms, and 25 
ms step rate for the SA800, SA850, and SA450, 
respectively; MPI 5l/52s require a 5 ms step rate; 
Memorex 550 requires a 6 ms step rate. The STEP 
equates set the step rates to 6 ms for single-sided 
8" drives and 30 ms for 5.25" drives (see Table A-1 
below) . These step rates will work with almost all 
drives; however, some SA800 drives might require a 
slower step rate, while drives which can support a 
faster step rate may operate noisily. You may wish 
to implement one of the alternative step rates shown 
in Table A-1 below. 

STEPS EQU N STEPS EQU N 



N 


STEP 


RATE 





6 


ms 


1 


12 


ms 


2 


20 


ms 


3 


30 


ms 



N 


STEP 


RATE 





3 


ms 


1 


6 


ms 


2 


10 


ms 


3 


15 


ms 



Table A-1. Step Rate Values 

Note the step rate for double-sided 8" drives is 
fixed at 3 ms and cannot be easily altered. All 
double-sided B" drives should operate well at that 
step rate. 
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4. Finally, make any necessary changes to the source code 
regarding double-sided drives, sector skew, extended-track 
mini driv.es, etc. See the appropriate appendices. 

5. Assemble CC30BIOS.ASM, using Digital Research's MACro 
Assembler . YOUR ASSEMBLEP CC30BIOS SHOULD NOT EXCEED 3 . 5K 
BYTES IN TOTAL LENGTH. 

6. Place a blank diskette into drive B and initialize it for 
double-density, 1024-byte sectors using CC30INIT. 

7. Using MOVCPM, read the system into memory. To read in a 
64K version of the system (present configuration) , use the 
command 

A> MOVCPM * *<cr> 

To read in a version of the system reconfigured for 
another memory size, use the command 

A> MOVCPM n *<cr> 

where n equals the memory size desired in kilobytes. 

8. Save the system image on the new diskette: 

A> SAVE 40 B; CPMn.COM (n is the system memory size 

in Kbytes) 

The MOVCPM program displays the actual command you should 
use . 

9 . Now, in preparation for patching your new BIOS onto the 
system, load in CPMn.COM using DDT: 

A>DDT B: CPMn.COM 



DDT VERS 2.2 
NEXT PC 
nnnn 0100 

An image of CP/M now resides in memory, beginning at 900h. 
A memory map is as follows: 

900H CC30BOOT 

980H CCP 

1180H BDOS 

1F80H BIOS (the original CC30BIOS) 

10. Read CC30BIOS.HEX into place at 1F80H. Since DDT loads 
hex files at their origin, it will be necessary to specify 
an offset to get your version of CC30BIOS to load in at 
1F80H. The offset will vary according the size memory 



MEMORY 


BIOS 


SIZE 


ORIGIN 


20K 


4200H 


24K 


5200H 


32K 


7200H 


40K 


9200H 


48K 


B200H 


56K 


D200H 


62K 


EA00H 


64K 


F200H 
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CC30BIOS.HEX is configured for, since the origin will 
vary. Table A-2 gives offsets for common memory sizes. 
If your memory size is not listed, you will have to 
calculate it as described in steps a and b below. 

OFFSET 



DD80H 
CD80H 
AD80H 
8D80H 
6D80H 
4D80H 
3580H 
2D80H 



Table A-2. CC30BIOS Offsets 

a. To calculate the offset, first determine the origin of 
your BIOS. The formula is 4200h + b, where b is the 
hex value of the difference in Kbytes between your CP/M 
system size and 20K. 

b. Now use the hex command (undocumented in the DDT 
manual) to subtract the BIOS origin from 1F80H: 

- H1F80 nnnn (nnnn = BIOS origin) 

ssss dddd (ssss and dddd are the sum and difference) 

The difference is the offset. 

11. Read CC30BIOS into place, specifying the offset and exit 
DDT: 

- ICC30BIOS.HEX 

-Rdddd (dddd=offset) 

nnnn pppp 

-G0 

Note the value of nnnn; it is the top load address for 
your modified CC30BIOS and will be needed in the next 
step. 

12. Save the system image on the new diskette for future 
reference. To calculate the number of pages to save, 
subtract 100h from the top load address of CC30BIOS (nnnn 
aBdve) and then round lip to even 100h bytes. Translate 
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the result into 256-byte pages in decimal (100H bytes 
equal 1 page) . 

A>SAVE XX B: CPMn.COM 



13. Write the patched system onto the new system diskette using 
CC30GEN: 

A>CC30GEN 

CCS SYSTEM GENERATION PROGRAM 1.1 
COPYRIGHT 1980 CALIFORNIA COMPUTER SYSTEMS 

SOURCE DRIVE: <cr> 

DESTINATION DRIVE: B 

DESTINATION DRIVE ON B, THEN TYPE RETURN <cr> 

SYSTEM COPY AND VERIFICATION ENDED NO ERRORS 

14. You now have a customized system on the diskette. Insert 
the diskette into Drive A, reset the system, and you are 
now up and running on your customized version of CP/M. 



APPENDIX B 



DOUBLE-SIDED MINI DRIVES 



PURPOSE 



The CCS Floppy Disk Controller supports double- sided mini 
and maxi drives. However, the current System 300 version of 
CP/m 2.2 does not support double-sided mini drives, since they 
do not provide a status signal to identify when a double-sided 
diskette is mounted. Thus any general software developed by 
CCS would have to implement either single- or double-sided 
mini diskette operations, but not both. Since single-sided 
drives are more common, CCS decided to implement single-sided 
operation. 

There are two basic methods of implementing double-sided 
drive capabilities: 

A. The reverse side of each diskette can be treated as an 
extension of the obverse side. In its easiest form, this 
method treats each track on side 1 as an extension of the 
corresponding track on side 0; these associated tracks are 
often called cylinders. For example, a track on a 128-byte 
per sector, single-density 8" diskette would logically 
consist of sectors 1-26 on side and sectors 27-52 on side 
1; 

B. Each side of the diskette can be treated as a separate 
logical unit of assignment; that is, each physical drive is 
treated as two logical drives . 

CC30BIOS uses method A to support 8" double-sided drives. 
Most of the code for implementing double-sided mini drives 
under method A already exists; this appendix identifies the 
few changes that need to be made the code. 
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METHOD 



To implement double-sided mini drives, only the 5.25" 
disk parameter tables (DP5xx) need to be changed to accomodate 

the increased capacity of double-sided drives , The new values 

for these tables can be defined by using the CP/m DISKDEF 
macro to suit your individual desires or you can use the 
following suggested values: 



TABLES DPS XX 
Parameters S0 SI S3 D0 Dl D2 



Sectors Per Track 


36 


40 


32 


58 


72 


80 


Block Shift Factor 


3 


3 


3 


3 


4 


4 


Block Mask 


7 


7 


7 


7 


15 


15 


Extent Mask 














1 


1 


Blocks Per Disk 


143 


159 


127 


231 


143 


159 


No. Dir Entries 


63 


63 


63 


63 


63 


63 


ALLOC 


192 


192 


192 


192 


128 


128 


ALLOC 1 




















Dir Check Vector Size 


16 


16 


16 


16 


16 


16 


System Track Offset 


3 


3 


3 


3 


3 


3 



Note: For disks formatted in 512-byte, single-density 
sectors and in 1024-byte, double-density sectors, the 
software uses Tables DP5S1 and DP5S2, respectively. 



Table B-1. Double-sided Mini Parameters 



We arrived at these values by using the DISKDEF Macro and 
judgement. For instance, we chose the block size (CP/M's 
logical allocation data size increment) so that every block on 
the diskette could be defined by an 8-bit value. Similarly, 
we selected a number for directory entries sufficient for the 
diskette capacity. 
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EXTENDED-TRACK MINI DRIVES 



PURPOSE: 



The distribution version of CC30BIOS supports 8" drives 
with 77 tracks and 5.25" diskettes with 35 tracks. However, 
some mini drives have more than 35 tracks available: the MPI 
B-51/52, Tandon TM 100, and QUME Data Track 5 have 40 tracks, 
while the MPI B-91/92 have 80 tracks. This appendix 
identifies the CC30BIOS changes necessary to take advantage of 
the these drives' added capacity. 



METHOD : 



In the case of single-sided drives, only the disk 
parameter tables in CC30BIOS need to be changed. The 
necessary changes to the tables are shown below. In the case 
of the double-sided drives, the changes identified in Appendix 
B for installing double-sided drives also need to be made. In 
addition, some of the drives can support a faster step rate; 
see Appendix A. 



DP5S0: 



Drives: 


SINGLE- 


-SIDED 


Tracks: 


40 


80 


DW 


18 


18 


DB 


3 


3 


DB 


7 


7 


DB 








DW 


82 


172 


DW 


63 


63 


DB 


192 


192 


DB 








DW 


16 


16 


DW 


3 


3 



DOUBLE- 


-SIDED 


40 


80 


36 


36 


3 


4 


7 


15 





1 


165 


172 


63 


63 


192 


128 








16 


16 


3 


3 
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DP5S1 



DP5S3 



DP5D0 



DP5D1: 



DP5D2 



DW 


20 


20 


40 


40 


DB 


3 


3 


3 


4 


DB 


7 


7 


7 


15 


DB 











1 


DW 


91 


192 


184 


192 


DW 


63 


63 


63 


63 


DB 


192 


192 


192 


128 


DB 














DW 


16 


16 


16 


16 


DW 


3 


3 


3 


3 


DW 


16 


16 


32 


32 


DB 


3 


3 


3 


4 


DB 


7 


7 


7 


15 


DB 











1 


DW 


73 


153 


147 


153 


DW 


63 


63 


63 


63 


DB 


192 


192 


192 


128 


DB 














DW 


16 


16 


16 


16 


DW 


3 


3 


3 


3 


DW 


29 


29 


58 


58 


DB 


3 


4 


4 


5 


DB 


7 


15 


15 


31 


DB 





1 


1 


3 


DW 


133 


138 


133 


138 


DW 


63 


63 


63 


127 


DB 


192 


128 


128 


128 


DB 














DW 


16 


16 


16 


32 


DW 


3 


3 


3 


3 


DW 


36 


36 


72 


72 


DB 


3 


4 


4 


5 


DB 


7 


15 


15 


31 


DB 





1 


1 


3 


DW 


165 


172 


165 


172 


DW 


63 


63 


63 


127 


DB 


192 


128 


128 


128 


DB 














DW 


16 


16 


16 


32 


DW 


3 


3 


3 


3 


DW 


40 


40 


80 


80 


DB 


3 


4 


4 


5 


DB 


7 


15 


15 


31 


DB 





1 


1 


3 


DW 


184 


192 


184 


192 


DW 


63 


63 


63 


127 


DB 


192 


128 


128 


128 


DB 














DW 


16 


16 


16 


32 


DW 


3 


3 


3 


3 



Note: The disk parameter tables DP5S1 and DP5D2 are also used 
for 512-byte, single-density and 1024-byte double-density 
diskettes, respectively. 



APPENDIX D 



SECTOR SKEW 



PURPOSE: 



CC30BIOS uses sector skew to increase disk access speed. 
Between each sector read or write, most programs need to 
perform a certain amount of processing. Since the next 
physical sector will have already rotated past the head, it 
would be inefficient for CC30BIOS to wait until that sector 
came around again for the next sector, read or write. 
Instead, CC30BIOS chooses the physical location for the next 
logical sector based on the sector skew factor. The sector 
skew factor is selected so that most programs have adequate 
processing time before the physical sector selected for the 
next read or write operation is detected. The skew factor 
CC30BIOS uses is dependent on diskette size and format. For 
example, an 8", single-density diskette with 128-byte sectors 
is given a skew factor of six, so that the next logical sector 
is the sixth subsequent physical sector, while a 5.25", 
single-density diskette with 256-byte sectors is given a skew 
factor of 3 . 

Since programs differ in the amount of processing time they 
require, changing the sector skew factors may increaae disk 
access speed. For example, a program requiring extensive 
processing between sector reads or writes may not be given 
sufficient processing time by the sector skew factor and thus 
miss the next logical sector. It would then have to wait one 
full revolution of the disk. If the sector skew factor is 
gradually increased, a sector skew factor will be arrived at 
where the program is given enough processing time to pick up 
the next sector on the same revolution of the disk, resulting 
in a sharp decrease in disk access time. This would be the 
optimal sector sKev^ fSdtof. in the current version of 
CC30BIOS, the sector skew tables are generated by using an 
algorithm which may not be immediately obvious to a user 
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wishing to modify the tables. This appendix describes how to 
modify the tables. 



METHOD 



To change the sector skew values, you need to change two 
values in the skew table for a diskette of a particular size 
and format. The current sector skew tables are as follows: 



T848 


DB 


48,48,1 


T826 


DB 


26,13,6 


T815 


DB 


15,15,4 


T88 


DB 


8,8,3 


T84 


DB 


4,2,2 


T529 


DB 


29,29,7 


T518 


DB 


18,9,4 


T510 


DB 


10,10,3 


T55 


DB 


5,5,2 


T52 


DB 


2,2,1 



Table D-1. Sector Skew Tables 

The first value in each sector skew table is the number of 
sectors per track (one side only) and remains constant. The 
third value is the sector skew factor and can be modified to 
any number between 1 and the first value . The second number 
is the result of the first value divided by the greatest 
common denominator (GCD) of the first and third values. It 
must be changed if the new skew factor results in a different 
GCD. For example, if you wanted to change the skew factor in 
table T510 to 5, the second value must change to 2 (GCD=5; 
10/5=2). Of course, CC30BIOS must be reassembled and 
installed (see Application Note 1 for procedure) . NOTE THAT 
THE SKEW FACTOR IN TABLE T826 IS AN INDUSTRY STANDARD AND 
SHOULD NOT BE CHANGED. 



